home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / AIncludes / FileTransfers.a < prev    next >
Text File  |  1996-05-01  |  9KB  |  376 lines
  1. ;
  2. ;    File:        FileTransfers.a
  3. ;
  4. ;    Contains:    CommToolbox File Transfer Manager Interfaces.
  5. ;
  6. ;    Version:    Technology:    System 7.5
  7. ;                Release:    Universal Interfaces 3.0d3 on Copland DR1
  8. ;
  9. ;    Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10. ;
  11. ;    Bugs?:        If you find a problem with this file, send the file and version
  12. ;                information (from above) and the problem description to:
  13. ;
  14. ;                    Internet:    apple.bugs@applelink.apple.com
  15. ;                    AppleLink:    APPLE.BUGS
  16. ;
  17. ;
  18.     IF &TYPE('__FILETRANSFERS__') = 'UNDEFINED' THEN
  19. __FILETRANSFERS__ SET 1
  20.  
  21.     IF &TYPE('__WINDOWS__') = 'UNDEFINED' THEN
  22.     include 'Windows.a'
  23.     ENDIF
  24.     IF &TYPE('__STANDARDFILE__') = 'UNDEFINED' THEN
  25.     include 'StandardFile.a'
  26.     ENDIF
  27.     IF &TYPE('__CTBUTILITIES__') = 'UNDEFINED' THEN
  28.     include 'CTBUtilities.a'
  29.     ENDIF
  30.     IF &TYPE('__CONNECTIONS__') = 'UNDEFINED' THEN
  31.     include 'Connections.a'
  32.     ENDIF
  33.     IF &TYPE('__FILES__') = 'UNDEFINED' THEN
  34.     include 'Files.a'
  35.     ENDIF
  36.     IF &TYPE('__TERMINALS__') = 'UNDEFINED' THEN
  37.     include 'Terminals.a'
  38.     ENDIF
  39.     IF FOR_SYSTEM7_ONLY THEN
  40.  
  41.                                                             ; current file transfer manager version    
  42. curFTVersion                    EQU        2                    ; FTErr    
  43. ftGenericError                    EQU        -1
  44. ftNoErr                            EQU        0
  45. ftRejected                        EQU        1
  46. ftFailed                        EQU        2
  47. ftTimeOut                        EQU        3
  48. ftTooManyRetry                    EQU        4
  49. ftNotEnoughDSpace                EQU        5
  50. ftRemoteCancel                    EQU        6
  51. ftWrongFormat                    EQU        7
  52. ftNoTools                        EQU        8
  53. ftUserCancel                    EQU        9
  54. ftNotSupported                    EQU        10
  55. ; typedef OSErr                         FTErr
  56.  
  57.  
  58. ftIsFTMode                        EQU        $01
  59. ftNoMenus                        EQU        $02
  60. ftQuiet                            EQU        $04
  61. ftConfigChanged                    EQU        $10
  62. ftSucc                            EQU        $80
  63. ; typedef unsigned long                 FTFlags
  64.  
  65.  
  66. ftSameCircuit                    EQU        $01
  67. ftSendDisable                    EQU        $02
  68. ftReceiveDisable                EQU        $04
  69. ftTextOnly                        EQU        $08
  70. ftNoStdFile                        EQU        $10
  71. ftMultipleFileSend                EQU        $20
  72. ; typedef unsigned short                 FTAttributes
  73.  
  74.  
  75. ftReceiving                        EQU        0
  76. ftTransmitting                    EQU        1
  77. ; typedef unsigned short                 FTDirection
  78.  
  79. ;     application routines type definitions 
  80.  
  81.  
  82. ; typedef FTRecord *                    FTPtr
  83.  
  84. ; typedef FTPtr *                        FTHandle
  85.  
  86. FTRecord                RECORD 0
  87. procID                     ds.w    1                ; offset: $0 (0)
  88. flags                     ds.l    1                ; offset: $2 (2)
  89. errCode                     ds.w    1                ; offset: $6 (6)
  90. refCon                     ds.l    1                ; offset: $8 (8)
  91. userData                 ds.l    1                ; offset: $C (12)
  92. defProc                     ds.l    1                ; offset: $10 (16)
  93. config                     ds.l    1                ; offset: $14 (20)
  94. oldConfig                 ds.l    1                ; offset: $18 (24)
  95. environsProc             ds.l    1                ; offset: $1C (28)
  96. reserved1                 ds.l    1                ; offset: $20 (32)
  97. reserved2                 ds.l    1                ; offset: $24 (36)
  98. ftPrivate                 ds.l    1                ; offset: $28 (40)
  99. sendProc                 ds.l    1                ; offset: $2C (44)
  100. recvProc                 ds.l    1                ; offset: $30 (48)
  101. writeProc                 ds.l    1                ; offset: $34 (52)
  102. readProc                 ds.l    1                ; offset: $38 (56)
  103. owner                     ds.l    1                ; offset: $3C (60)
  104. direction                 ds.w    1                ; offset: $40 (64)
  105. theReply                 ds        SFReply            ; offset: $42 (66)
  106. writePtr                 ds.l    1                ; offset: $8C (140)
  107. readPtr                     ds.l    1                ; offset: $90 (144)
  108. theBuf                     ds.l    1                ; offset: $94 (148)
  109. bufSize                     ds.l    1                ; offset: $98 (152)
  110. autoRec                     ds        Str255            ; offset: $9C (156)
  111. attributes                 ds.w    1                ; offset: $19C (412)
  112. sizeof                     EQU *                    ; size:   $19E (414)
  113.                         ENDR
  114.  
  115.                                                             ; FTReadProc messages 
  116. ftReadOpenFile                    EQU        0                    ; count = forkFlags, buffer = pblock from PBGetFInfo 
  117. ftReadDataFork                    EQU        1
  118. ftReadRsrcFork                    EQU        2
  119. ftReadAbort                        EQU        3
  120. ftReadComplete                    EQU        4
  121. ftReadSetFPos                    EQU        6                    ; count = forkFlags, buffer = pBlock same as PBSetFPos 
  122. ftReadGetFPos                    EQU        7                    ; count = forkFlags, buffer = pBlock same as PBGetFPos 
  123.                                                             ; FTWriteProc messages 
  124. ftWriteOpenFile                    EQU        0                    ; count = forkFlags, buffer = pblock from PBGetFInfo 
  125. ftWriteDataFork                    EQU        1
  126. ftWriteRsrcFork                    EQU        2
  127. ftWriteAbort                    EQU        3
  128. ftWriteComplete                    EQU        4
  129. ftWriteFileInfo                    EQU        5
  130. ftWriteSetFPos                    EQU        6                    ; count = forkFlags, buffer = pBlock same as PBSetFPos 
  131. ftWriteGetFPos                    EQU        7                    ; count = forkFlags, buffer = pBlock same as PBGetFPos 
  132.                                                             ;    fork flags 
  133. ftOpenDataFork                    EQU        1
  134. ftOpenRsrcFork                    EQU        2
  135. ;
  136. ; pascal FTErr InitFT(void )
  137. ;
  138.     IF GENERATINGCFM THEN
  139.         IMPORT_CFM_FUNCTION InitFT
  140.     ENDIF
  141.  
  142. ;
  143. ; pascal Handle FTGetVersion(FTHandle hFT)
  144. ;
  145.     IF GENERATINGCFM THEN
  146.         IMPORT_CFM_FUNCTION FTGetVersion
  147.     ENDIF
  148.  
  149. ;
  150. ; pascal short FTGetFTVersion(void )
  151. ;
  152.     IF GENERATINGCFM THEN
  153.         IMPORT_CFM_FUNCTION FTGetFTVersion
  154.     ENDIF
  155.  
  156. ;
  157. ; pascal FTHandle FTNew(short procID, FTFlags flags, FileTransferSendUPP sendProc, FileTransferReceiveUPP recvProc, FileTransferReadUPP readProc, FileTransferWriteUPP writeProc, FileTransferEnvironsUPP environsProc, WindowPtr owner, long refCon, long userData)
  158. ;
  159.     IF GENERATINGCFM THEN
  160.         IMPORT_CFM_FUNCTION FTNew
  161.     ENDIF
  162.  
  163. ;
  164. ; pascal void FTDispose(FTHandle hFT)
  165. ;
  166.     IF GENERATINGCFM THEN
  167.         IMPORT_CFM_FUNCTION FTDispose
  168.     ENDIF
  169.  
  170. ;
  171. ; pascal FTErr FTStart(FTHandle hFT, FTDirection direction, const SFReply *fileInfo)
  172. ;
  173.     IF GENERATINGCFM THEN
  174.         IMPORT_CFM_FUNCTION FTStart
  175.     ENDIF
  176.  
  177. ;
  178. ; pascal FTErr FTAbort(FTHandle hFT)
  179. ;
  180.     IF GENERATINGCFM THEN
  181.         IMPORT_CFM_FUNCTION FTAbort
  182.     ENDIF
  183.  
  184. ;
  185. ; pascal FTErr FTSend(FTHandle hFT, short numFiles, FSSpecArrayPtr pFSSpec, FileTransferNotificationUPP notifyProc)
  186. ;
  187.     IF GENERATINGCFM THEN
  188.         IMPORT_CFM_FUNCTION FTSend
  189.     ENDIF
  190.  
  191. ;
  192. ; pascal FTErr FTReceive(FTHandle hFT, FSSpecPtr pFSSpec, FileTransferNotificationUPP notifyProc)
  193. ;
  194.     IF GENERATINGCFM THEN
  195.         IMPORT_CFM_FUNCTION FTReceive
  196.     ENDIF
  197.  
  198. ;
  199. ; pascal void FTExec(FTHandle hFT)
  200. ;
  201.     IF GENERATINGCFM THEN
  202.         IMPORT_CFM_FUNCTION FTExec
  203.     ENDIF
  204.  
  205. ;
  206. ; pascal void FTActivate(FTHandle hFT, Boolean activate)
  207. ;
  208.     IF GENERATINGCFM THEN
  209.         IMPORT_CFM_FUNCTION FTActivate
  210.     ENDIF
  211.  
  212. ;
  213. ; pascal void FTResume(FTHandle hFT, Boolean resume)
  214. ;
  215.     IF GENERATINGCFM THEN
  216.         IMPORT_CFM_FUNCTION FTResume
  217.     ENDIF
  218.  
  219. ;
  220. ; pascal Boolean FTMenu(FTHandle hFT, short menuID, short item)
  221. ;
  222.     IF GENERATINGCFM THEN
  223.         IMPORT_CFM_FUNCTION FTMenu
  224.     ENDIF
  225.  
  226. ;
  227. ; pascal short FTChoose(FTHandle *hFT, Point where, FileTransferChooseIdleUPP idleProc)
  228. ;
  229.     IF GENERATINGCFM THEN
  230.         IMPORT_CFM_FUNCTION FTChoose
  231.     ENDIF
  232.  
  233. ;
  234. ; pascal void FTEvent(FTHandle hFT, const EventRecord *theEvent)
  235. ;
  236.     IF GENERATINGCFM THEN
  237.         IMPORT_CFM_FUNCTION FTEvent
  238.     ENDIF
  239.  
  240. ;
  241. ; pascal Boolean FTValidate(FTHandle hFT)
  242. ;
  243.     IF GENERATINGCFM THEN
  244.         IMPORT_CFM_FUNCTION FTValidate
  245.     ENDIF
  246.  
  247. ;
  248. ; pascal void FTDefault(Ptr *theConfig, short procID, Boolean allocate)
  249. ;
  250.     IF GENERATINGCFM THEN
  251.         IMPORT_CFM_FUNCTION FTDefault
  252.     ENDIF
  253.  
  254. ;
  255. ; pascal Handle FTSetupPreflight(short procID, long *magicCookie)
  256. ;
  257.     IF GENERATINGCFM THEN
  258.         IMPORT_CFM_FUNCTION FTSetupPreflight
  259.     ENDIF
  260.  
  261. ;
  262. ; pascal void FTSetupSetup(short procID, const void *theConfig, short count, DialogPtr theDialog, long *magicCookie)
  263. ;
  264.     IF GENERATINGCFM THEN
  265.         IMPORT_CFM_FUNCTION FTSetupSetup
  266.     ENDIF
  267.  
  268. ;
  269. ; pascal Boolean FTSetupFilter(short procID, const void *theConfig, short count, DialogPtr theDialog, EventRecord *theEvent, short *theItem, long *magicCookie)
  270. ;
  271.     IF GENERATINGCFM THEN
  272.         IMPORT_CFM_FUNCTION FTSetupFilter
  273.     ENDIF
  274.  
  275. ;
  276. ; pascal void FTSetupItem(short procID, const void *theConfig, short count, DialogPtr theDialog, short *theItem, long *magicCookie)
  277. ;
  278.     IF GENERATINGCFM THEN
  279.         IMPORT_CFM_FUNCTION FTSetupItem
  280.     ENDIF
  281.  
  282. ;
  283. ; pascal void FTSetupXCleanup(short procID, const void *theConfig, short count, DialogPtr theDialog, Boolean OKed, long *magicCookie)
  284. ;
  285.     IF GENERATINGCFM THEN
  286.         IMPORT_CFM_FUNCTION FTSetupXCleanup
  287.     ENDIF
  288.  
  289. ;
  290. ; pascal void FTSetupPostflight(short procID)
  291. ;
  292.     IF GENERATINGCFM THEN
  293.         IMPORT_CFM_FUNCTION FTSetupPostflight
  294.     ENDIF
  295.  
  296. ;
  297. ; pascal Ptr FTGetConfig(FTHandle hFT)
  298. ;
  299.     IF GENERATINGCFM THEN
  300.         IMPORT_CFM_FUNCTION FTGetConfig
  301.     ENDIF
  302.  
  303. ;
  304. ; pascal short FTSetConfig(FTHandle hFT, const void *thePtr)
  305. ;
  306.     IF GENERATINGCFM THEN
  307.         IMPORT_CFM_FUNCTION FTSetConfig
  308.     ENDIF
  309.  
  310. ;
  311. ; pascal OSErr FTIntlToEnglish(FTHandle hFT, const void *inputPtr, Ptr *outputPtr, short language)
  312. ;
  313.     IF GENERATINGCFM THEN
  314.         IMPORT_CFM_FUNCTION FTIntlToEnglish
  315.     ENDIF
  316.  
  317. ;
  318. ; pascal OSErr FTEnglishToIntl(FTHandle hFT, const void *inputPtr, Ptr *outputPtr, short language)
  319. ;
  320.     IF GENERATINGCFM THEN
  321.         IMPORT_CFM_FUNCTION FTEnglishToIntl
  322.     ENDIF
  323.  
  324. ;
  325. ; pascal void FTGetToolName(short procID, Str255 name)
  326. ;
  327.     IF GENERATINGCFM THEN
  328.         IMPORT_CFM_FUNCTION FTGetToolName
  329.     ENDIF
  330.  
  331. ;
  332. ; pascal short FTGetProcID(ConstStr255Param name)
  333. ;
  334.     IF GENERATINGCFM THEN
  335.         IMPORT_CFM_FUNCTION FTGetProcID
  336.     ENDIF
  337.  
  338. ;
  339. ; pascal void FTSetRefCon(FTHandle hFT, long refCon)
  340. ;
  341.     IF GENERATINGCFM THEN
  342.         IMPORT_CFM_FUNCTION FTSetRefCon
  343.     ENDIF
  344.  
  345. ;
  346. ; pascal long FTGetRefCon(FTHandle hFT)
  347. ;
  348.     IF GENERATINGCFM THEN
  349.         IMPORT_CFM_FUNCTION FTGetRefCon
  350.     ENDIF
  351.  
  352. ;
  353. ; pascal void FTSetUserData(FTHandle hFT, long userData)
  354. ;
  355.     IF GENERATINGCFM THEN
  356.         IMPORT_CFM_FUNCTION FTSetUserData
  357.     ENDIF
  358.  
  359. ;
  360. ; pascal long FTGetUserData(FTHandle hFT)
  361. ;
  362.     IF GENERATINGCFM THEN
  363.         IMPORT_CFM_FUNCTION FTGetUserData
  364.     ENDIF
  365.  
  366. ;
  367. ; pascal void FTGetErrorString(FTHandle hFT, short id, Str255 errMsg)
  368. ;
  369.     IF GENERATINGCFM THEN
  370.         IMPORT_CFM_FUNCTION FTGetErrorString
  371.     ENDIF
  372.  
  373.     ENDIF
  374.     ENDIF ; __FILETRANSFERS__ 
  375.  
  376.